using System;
using System.Collections.Generic;

namespace WCS.Infrastructure.Dto.Request.Ai
{
    /// <summary>
    /// 文件说明：AI 对话请求参数
    /// 作用：封装调用混元 chat/completions 的必要与可选参数
    /// 作者：系统自动生成
    /// 日期：2025-11-19
    /// </summary>
    public class ChatRequestDto
    {
        /// <summary>
        /// 模型名称，默认可由后端配置覆盖，如 hunyuan-turbos-latest
        /// </summary>
        public string? model { get; set; }

        /// <summary>
        /// 消息列表（包含历史上下文）
        /// </summary>
        public List<ChatMessageDto> messages { get; set; } = new List<ChatMessageDto>();

        /// <summary>
        /// 是否启用增强（enable_enhancement）
        /// </summary>
        public bool? enable_enhancement { get; set; }

        /// <summary>
        /// 采样温度（可选）
        /// </summary>
        public double? temperature { get; set; }

        /// <summary>
        /// Top-p（可选）
        /// </summary>
        public double? top_p { get; set; }

        /// <summary>
        /// 最大生成 token 数（可选）
        /// </summary>
        public int? max_tokens { get; set; }

        /// <summary>
        /// 是否启用流式输出（SSE），OpenAI 兼容参数
        /// </summary>
        public bool? stream { get; set; }
    }
}